安装 Node.js

使用 Docker 的同学请忽略

Windows

Download | Node.js
下载 .msi 安装包并安装

macOS

Download | Node.js
下载 .pkg 安装包并安装

Linux

Installing Node.js via package manager | Node.js
参照教程安装 nodejs

当然用 macOS 的 Homebrew，Windows 的 Scoop 等包管理器安装也可以，根据个人喜好选择即可

Android 平台的终端模拟器如 Termux，NeoTerm 等也可以安装 Node.js，教程非常多，请善用搜索

下载项目

使用 Docker，npx，npm 全局安装的同学请忽略

方法❶ 使用 Git 克隆

git clone https://github.com/nondanee/UnblockNeteaseMusic.git #克隆项目仓库
cd UnblockNeteaseMusic #进入项目根目录

方法❷ 下载源码压缩包

在项目首页点击 Clone or download 绿色按钮，选择 Download ZIP 并解压
或在 Release 页面下载 Assets 中的 Source code (zip) 或 Source code (tar.gz) 压缩包并解压

打开项目目录后

Windows 用户请按住 Shift 后点击右键，选择 "在此处打开 PowerShell 窗口(S)"
macOS 用户可以借助 OpenInTerminal，Go2Shell 等工具快捷打开终端窗口

安装依赖

不需要

启动方式

下述启动命令 node app.js 可以等效替换为

npx @nondanee/unblockneteasemusic

# npm i -g @nondanee/unblockneteasemusic
unblockneteasemusic

docker run [OPTIONS] nondanee/unblockneteasemusic

如果看不懂请直接忽略

使用方法① (代理模式)

1. 直接启动

node app.js

2. 配置代理

各系统下的基础配置参见 README

• PAC 模式

填写脚本地址 http://127.0.0.1:8080/proxy.pac

• 全局代理模式

填写服务器地址 127.0.0.1 和端口号 8080

由于网易云 Windows 客户端的 Bug，测试代理会报错 "该代理不可使用"，实际并不影响
看到 Server running @ http://0.0.0.0:8080 之后出现如 MITM > ... 的请求日志即配置成功

使用方法② (hosts 模式)

1. 寻找网易云服务器的IP

ping music.163.com

得到类似 223.252.199.66 的IP

2. 向hosts文件添加记录

127.0.0.1 music.163.com
127.0.0.1 interface.music.163.com

Windows hosts C:\Windows\System32\drivers\etc\hosts
Linux/macOS hosts /etc/hosts

3. 设置参数启动

node app.js -p 80 -f 223.252.199.66

若在 linux/macOS下报错 Error: listen EACCES 0.0.0.0:80 请加 sudo

其它配置

参数可叠加

开启严格模式

node app.js -s ...

设置搜索的音源 (有序)

默认为 qq kuwo migu，排在越前优先级越高，启用越多网络开销越大

node app.js -o joox qq ...

使用自定义端口

node app.js -p 5000 ...

使用 jixun 的反代服务器

node app.js -f 79.137.38.20 ...

使用上游 http / https 代理

node app.js -u http://127.0.0.1:1080 ...

这对于没有基础的人来说太难了，我用node.js里面的command通过 CD 进入目录来安装commander，然后输入 node app.js 它提示 Server running @ http://0.0.0.0:8080，可是通过客户端设置代理却说代理不可用

能出个简易的视频教程吗？@nondanee，windows下真的不会弄

@johoney 抱歉啊忘记说明了，Windows客户端设置代理报不可用是正常的😂，网易云自己的bug，只要running提示底下有新的代理请求日志就是成功了

@nondanee 好的谢谢，已经成功解决了，不过我有个问题可以设置类似快捷启动的东西，然后打开这个就能迅速启动代理吗，我希望可以把它加入到shell:startup,这样就不用那么麻烦的启动了。记得之前这个项目是有exe的，不过最近失效了所以我才使用了这个最新的程序了。

@johoney
因为 release 麻烦啊，所以不发可执行文件了😂
项目根目录里新建一个 .bat 文件，写入 node app，之后双击就可以启动了
或者在项目根目录执行 npm link，之后在命令行或者 win +r 里直接输入 unblockneteasemusic 就能启动

@nondanee 太谢谢你了，开发者真棒！

bat比较实用

@nondanee 居然贴心的出了这么详细的图文教程拉过来猛抱抱～
最近好像用之前打包好的文件不太稳定，新版不提供打包好的文件有点点不便。。
顺便问一下有办法在路由器里做启动么，省的每台设备都要启动一下。。

@shugo-chara
只有文没有图😂
更新很频繁，打包太累了，有 node 环境的话你可以自己打包

npm install pkg
npm run pkg

额路由器上运行的话估计不太现实。。。局域网里找一台常开的电脑跑着就行了

建议把这里的说明添加到 Wiki 里面，感觉大家不会来 Issue 里面找教程的。（逃走 ε=ε=ε=┏(゜ロ゜;)┛

@spencerwoo98 因为写wiki里不好回复啊😥

----------------------------- 19.12.16 更新-----------------------------
网易云音乐 Mac 客户端更新
目标代理域名更新为：*.music.163.com;*.music.126.net;*.netease.com;

----------------------------- 19.06.28 更新-----------------------------

mac 搭配 Proxifier 配置参考

mac 需要使用 **https 代理 两个程序：NeteaseMusic;com.apple.WebKit.Networking
目标代理域名只需要写：*.music.163.com;*.music.126.net;*.netease.com;

需要在所有客户端（mac， iPhone 等）安装仓库里的证书并设置信任（参考#65 (comment) ）
有人反映使用仓库的证书 iOS 不能正常使用，我使用的是自签证书 暂时没有问题。
服务端启动命令为 node app.js -p port1:port2，客户端需要使用的是 port1 端口（port2 是用来内部转发的 https 端口，随便写一个就行）
放在 VPS 上跑也一样，客户端安装并信任了证书就可以了

iOS 使用配置参考

iOS 上我使用的是 Shadowrocket （参考：#65 (comment) ）

1. 右上角加号添加节点，填一个备注名比如 UnblockNetease
2. 类型选择 HTTP （注意不是HTTPS）
3. 服务器填写你搭建服务的 IP 地址
4. 端口填写你启动服务的端口号 （就是 port1）
5. 然后底部找到配置 点击本地文件 -> default.conf（你当前使用的配置） -> 编辑配置 -> 添加规则
6. 添加下面三条规则，选项都选择刚添加的 UnblockNetease 节点，类型和用户代理/域名如下

• USER-AGENT: NeteaseMusic*
• DOMAIN-SUFFIX: music.163.com
• DOMAIN-SUFFIX: music.126.net

PS. 记得安装证书并信任，添加了之后不行的话重置一下 Shadowrocket 再试

丢个链接，详细教程 https://www.sheyilin.com/2019/06/unblockneteasemusic/

Windows碰到这种情况该怎么办呢？小白一个，只看得懂第二种方法，然而会直接报错...

G:\NeteaseMusic\UnblockNeteaseMusic-master>node app.js -p 80 -f 59.111.160.197
Server running @ http://0.0.0.0:80
events.js:167
      throw er; // Unhandled 'error' event
      ^

Error: listen EACCES 0.0.0.0:80
    at Server.setupListenHandle [as _listen2] (net.js:1269:19)
    at listenInCluster (net.js:1334:12)
    at Server.listen (net.js:1421:7)
    at Promise.all.then.result (G:\NeteaseMusic\UnblockNeteaseMusic-master\app.js:58:9)
    at process._tickCallback (internal/process/next_tick.js:68:7)
Emitted 'error' event at:
    at emitErrorNT (net.js:1313:8)
    at process._tickCallback (internal/process/next_tick.js:63:19)

@PLUSLEE 管理员身份启动命令行试一下，也检查一下80端口是否被其它程序使用

netstat -ano | find "80"

@nondanee 谢谢，跑通了...客户端少了一步。万分感谢！从即刻App关注的“网路冷眼”微博上发现这个好东西

我的使用情况是，
服务想安装在公网服务器上，但不能运行在80端口。——修改hosts文件方式不可用
本机运行一个SS客户端，系统代理已经被它的pac地址占据了——修改系统代理也不可用

SS的pac文件是工具生成的，所以还不好做修改
感觉需要一个工具串联不同代理了，不知道有没有这样的软件

@daorren

1. 好像无解
2. SS 客户端，代理设置，编辑 pac 用户自定规则，试试看

@gqbre
这个理论上没用的，SS的pac文件是用gfwlist2pac生成的，自定义规则那里只是配置了需要代理的数据项

@youyiqin
设置全局代理，普通地址访问不了？不会吧，是不是启动失败了？还是地址填错了？有 log 吗？

想问一下为什么我windows下用host方法失败了0_0
用pac和在网易云里面手动代理都可以正常工作
参考了使用方法2
启动：node app.js -p 80 -f 59.111.181.38
host改了也flush过了
打开网易云还是灰的 music.163.com访问不了
全程无报错 log也毫无反应
然后安卓下改host也是一样的问题 pac正常
谢谢

问一下怎么部署到winserver给安卓用啊？还是说要搭配v2ray
ipad已经可以用了但三星不行
没事了升级了就好了

mac下有没有一个比较完整的教程啊?
issue套issue, 照着 自签了证书、改了hosts文件、用了代理软件，最后还是用不起来的表示很着急。。。

亲测好用，已star。但是我发现windows上host模式不咋好使？用代理模式成功了

请问下以后是否可能支持服务器端的登录，如果服务器端登录VIP账号用来获取url则客户端账号无需VIP，更加方便

每次都要开powershell好麻烦啊，能不能直接用全局pac代理呢
我之前看过有另一个github里面的pac文件的代理，好像可以用，但是不知道会不会有问题

纯小白，想问问用这个文件本地设置全局代理的话，会不会有安全问题@nondanee 求解答

使用方法② (hosts 模式)

1. 寻找网易云服务器的IP

ping music.163.com

得到类似 223.252.199.66 的IP

2. 向hosts文件添加记录

127.0.0.1 music.163.com
127.0.0.1 interface.music.163.com

Windows hosts C:\Windows\System32\drivers\etc\hosts
Linux/macOS hosts /etc/hosts

3. 设置参数启动

node app.js -p 80 -f 223.252.199.66

若在 linux/macOS下报错 Error: listen EACCES 0.0.0.0:80 请加 sudo

你好,我是改host的模式,已经自签了证书并将server.crt和server.key覆盖到unblock项目下,
接着启动项目 node app.js -p 80 -f 59.111.181.60 报了个错
> Error: unable to verify the first certificate
at TLSSocket.onConnectSecure (node:_tls_wrap:1498:34)
at TLSSocket.emit (node:events:329:20)
at TLSSocket._finishInit (node:_tls_wrap:933:8)
at TLSWrap.ssl.onhandshakedone (node:_tls_wrap:707:12) {
code: 'UNABLE_TO_VERIFY_LEAF_SIGNATURE'
}
请问这种情况是否遇到过 QAQ

已经成功解决了,谢谢大佬~

mac下有没有一个比较完整的教程啊?
issue套issue, 照着 自签了证书、改了hosts文件、用了代理软件，最后还是用不起来的表示很着急。。。

https://www.sheyilin.com/2019/06/unblockneteasemusic
可以参考一下

iOS弄了一下可以听了，可是没办法下载歌曲，一直在获取文件大小，有办法解决吗？

请问安卓使用 http://ip:port/proxy.pac 的代理自动配置方式，会导致微信无法打开部分网页（目前发现金山的在线文档和问卷星的问卷网页）和京东部分页面无法正常加载如何解决？

Mac要怎么食用呢？
研究了一下没有找到mac 网易云的代理设置选项

Mac要怎么食用呢？
研究了一下没有找到mac 网易云的代理设置选项

油管有一个教程的，一个视频一会就可以搭好了

喵喵？求link? 有搜到的都是關於Proxifier代理network, 這樣和pac代理就沒有區別了

windows运行node app.js后,使用全局代理模式之后,在网易云代理测试会显示MITM>music163.com
但是打开客户端却提示网络不给力哦,这是什么情况呢?

这对于没有基础的人来说太难了，我用node.js里面的command通过 CD 进入目录来安装commander，然后输入 node app.js 它提示 Server running @ http://0.0.0.0:8080，可是通过客户端设置代理却说代理不可用

我用termux也是这样，怎么解决的呀，我的是Android端

关于UWP问题，其实还可以用一个程序：Fiddler 4

Hello every one,我编写一个一键配置脚本，欢迎使用
huangyanxiong01/auto-unlock-netease-music

有没有适配兼容clash可以用的配置单？

使用方法② (hosts 模式)

1. 寻找网易云服务器的IP

ping music.163.com

得到类似 223.252.199.66 的IP

2. 向hosts文件添加记录

127.0.0.1 music.163.com
127.0.0.1 interface.music.163.com

Windows hosts C:\Windows\System32\drivers\etc\hosts
Linux/macOS hosts /etc/hosts

3. 设置参数启动

node app.js -p 80 -f 223.252.199.66

若在 linux/macOS下报错 Error: listen EACCES 0.0.0.0:80 请加 sudo

mac v700,修改了hosts,node启动-p 80 -f ping网易得到的地址 客户端启动网络有问题,无响应?有什么办法吗?多谢,是否我有遗漏的操作.

Hosts的方式貌似用不了
root@10-23-129-163:~/UnblockNeteaseMusic# node app.js -p 80 -f 59.111.160.197
HTTP Server running @ http://0.0.0.0:80
MITM > interface.music.163.com
MITM > interface.music.163.com
MITM > interface.music.163.com
MITM > interface.music.163.com
MITM > music.163.com

music.163.com 无法访问

直接 执行 npx @nondanee/unblockneteasemusic
npx: installed 1 in 3.086s
HTTP Server running @ http://0.0.0.0:8080

但是 配置到 网易云 Http代理，重启 提示没有网络

网易云填入代理后测试可用，实际没用。我在琢磨琢磨其他方式

感谢开发者

win也需要自签证书么，我装了推荐的docker一开始win正常解锁，第二天就不行了，网页访问提示证书问题